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© Do a little of everything 
© Expand your horizons 
© Talk with other developers 
© Enjoy the city 
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C++ TR Defined 
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© Technical Report 
© An “informative document” 

© Not part of the C++ Standard 
© May become part of a future standard 


© Or not 
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TRl: A History 

® Formal work began in 2001 

® Most proposals came from Boost members 

© Approved in 2006 by ISO 

© In Spring 2006 all TRl except math functions 
added to draft of next Standard 


© Next Standard (C++0x) is due before the 
decade is out 
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What’s in TRl 



o 

® 

o 

o 

o 

® 


Fixed-sized arrays 
Hash tables 
Smart pointers 
Function objects 
Type traits 

Random number generators 
Tuples 

Call wrappers 
Regular expressions 
Advanced math functions 
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Why You Should Care 

© Efficiency 
© TRl is 

Lean and mean : more on that in a bit 
Standard : learn once, use everywhere 
Proven : avoid the not-invented-here syndrome 
Available : today, on platforms you care about 
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Where To Find TRl 


© Boost.org 


p boost 

C * t L I a R A R t E S 




Dinkumware.com 


DINEUM 

C-H+TRl 


5 Gcc.gnu. 
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Getting Started 

// TRl header 
#include <array> 

// fully qualified namespace 
std: : trl: :array< int, 4 > a; 


// or more likely . . . 
using namespace std:: trl; 
array< int, 4 > a; 
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Arrays: True Containers at Last 

® array< class T, size_t N > 

® Size fixed at compile time; contiguous space 
© Same performance as C-style arrays 
© Member functions you’d expect 


begin, end, size, op Q, at, front, back 

© Works with all std algorithms 

© Can be initialized using standard array 
initializers 


std: :trl: :array< int,4 > a = { 1,2, 3, 4 }; 
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Arrays: Take Control 

® Advantages 

Performance 

Size is part of the type 

Easy to convert array code to/from std:: vector 
More secure: must call dataQ to get ptr 


o Disadvantages 

Not growable 

No push_back, reserve, resize 
Must call data() to get ptr: inconvenient 
array.swapO is 0(n) 

@ vector is 0(1) 
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Hash Tables 

© Considered for original standard 
© Basic concept 

Super-fast search 
You control the hash algorithm 
Similar interface to other STL containers 
Low overhead: on par with set/map 
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Hash Table Conceptual Diagram 








Hash(e) 
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Unordered Associative Containers 

© Unordered 

A traversal is not ordered like set/map 

© Associative 

Dictionary pairs (K,T) 


© Containers 

Work with std iterators and algorithms 


© TRl naming 

std::trl::unordered_ [multi] set< K > 
std::trl::unordered_ [multi] map< K,T > 
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Hash Table Code Example 

#include <unordered_set> 
using namespace std::trl; 
unordered_set<int> ht; 


ht. insert ( 41 ); // add elements 
ht. insert ( 11 ); 
ht. insert ( 18 ); 


unordered_set<int>: : iterator it; 
it = ht.find( 41 ); // find element 

cMr' ■ 
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Real-World Performance 
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Evaluated three types of objects 

Light-weight: int 

® Hash = std::trl::hash<int> 

Medium-weight: std::complex<double> 

@ Hash = (size_t)( real + imag ) 


Heavy-weight: bitmap 

® Allocates, copy ctor calls memcpy 
® Hash = (size_t)( sum of first few pixels ) 

® 50,000 items in hash table 
® Tested on Xbox 360 


Few perturbations = consistent results 
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Element Insertion Performance 

© Sequence containers (vector, deque) 

Complexity: 0(1) 

© Associative containers (set, map) 

Complexity: O(log n) 


© Unordered associative containers 

Average time complexity: 0(1) 
Worst-cast time complexity: 0(n) 

© What was real-world performance? 
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Ticks 


Element Insertion (50,000 int) 



Ticks 


Element Insertion (50,000 complex<double>) 



Ticks 


Element Insertion (50,000 bitmap) 





Implementation Example 





u n 0 rd e red_m u ltiset< K> 
vector<list<K>::iterator> buckets 


h:\ 
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list<K> elems 
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Search Performance 
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© Sequence containers (vector, array) 

Complexity: 0(n), O(log n) if sorted 

© Associative containers (set, map) 

Complexity: O(log n) 


© Unordered associative containers 

Average time complexity: 0(1) 
Worst-cast time complexity: 0(n) 

© What was real-world performance? 
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Ticks 


Element Search (50,000 int) 



Ticks 


Element Search (50,000 complex<double>) 



•nil 


bitmap) 




Ticks 
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Hash Functions 

© Choosing the right hash function is critical! 

© Defaults provided for built-ins and std::string 
© For examples, see <unordered_set> 

© Hash references 


The Art of Computer Programming, Vol 3, Knuth 
Algorithms in C++, Sedgewick 
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Custom Hash Functions 

typedef std : : complex<double> cpx; 
struct CpxHash 

{ 

size_t operator 0 (const cpx& c) const 

{ 


return (size_t ) (c . real()+c . imag( ) ) ; 

} 



// Specify hash fn as template param 
unordered_set< cpx, CpxHash > ht; 


cMP" 
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Load Factors and Rehashing 

© Load factor = sizeQ / bucket_count() 

© Smaller load factor = better performance 
© You control the maximum load factor 

max_load_factor( float ); 


© When maximum exceeded, auto rehashes 
© You can also rehash directly 

rehash ( size_type buckets ); 
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Hash Tables: Take Control 



Advantages i® 

Search performance: 0(1) 

Tuning options (hash function, load factor) 
Insertions/deletions amortized 0(1) 
Equivalent or smaller overhead/elem than set 


o Disadvantages 

Not ordered 

No set_union, setjntersection 
No reverse traversal 
Depends on great hash function 
Requires key support op==() 
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C++ resource lifetimes 

Global 

Stack-based 

Static 


© No direct support for resources that have an 
intermediate lifetime 

© Enter shared_ptr<T> 


Ensures resources are available as long as 
needed and disposed when no longer needed 
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High-Octane Power 

© Smart ptr copied: ref count incremented 
© Dtor decrements ref count 
© Ref count goes to zero: ptr delete’d 
© Initialize with raw ptr 

shared_ptr<T> sp( new T(...) ); 


© Masquerades as a pointer for common usage 

T t(*sp); // T& operator* 0 const 

sp->func(); // T* operator->() const 

© Direct access available, too 


p = sp.getO; // T* get() const 
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Extended Example, Part A 

typedef std: : trl: :shared_ptr<Bitmap> SPB; 
struct SPBHash 

{ 

size_t operator 0 (const SPB& bp) const 
{ // hash = raw ptr address 

return (size_t)( bp.get() ); 



} 


}; 

// Store smart bitmaps for fast lookup 
unordered_set< SPB, SPBHash > ht; 


cMP" 
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Extended Example, Part B 

// Store bitmaps in hash table 
SPB spb( new Bitmap ( ... ) ); 
ht. insert ( spb ); 

ht. insert ( ... ); // Insert some more 
// Fast lookup 

unordered_set<SPB>: : iterator it; 

it = ht.find( spb ); 

int w = (*it) ->GetWidth( ) ; 

// Best part: no more code required 
// No more resource leaks 
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Object management 

Ctor: allocates block for ref count info 

Copy: ref count update 

Dtor: ref count update; deallocation calls 

Mgmt costs are insignificant for most objects 


Smart ptrs generally wrap much more costly objs 

© Smart ptr access is equivalent to raw ptrs 
*sp produces same code as *p 
sp-> produces same code as p-> 
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Smart Ptrs: Take Control 



® Advantages 

Automatic resource management 
Avoid memory leaks 
Can be stored in containers 
T ested 


o Disadvantages 

Ref count management overhead 

Ref count memory overhead 

Cycles require use of weak_ptr 

May not be thread-safe; chk your implementation 
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TRl: Take it for a 
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© Contact me 

Email: pkisensee@msn.com 
Homepage: www.tantalon.com/pete.htm 
Blog: pkisensee.spaces.live.com 


© Useful websites 


www.boost.org 

www.dinkumware.com 

qcc.gnu.org 


o Books and magazines 

C++ standard Library Extensions, Pete Becker 
Dr. Dobbs Journal; search on “TRl” 
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